home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / mailers / dbag_100.zip / DBAG.DOC next >
Text File  |  1992-08-24  |  13KB  |  304 lines
  1.    ───────────────────────────────────────────────────────────────────────
  2.    ▒▒▒ DBAG ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 1.00 ▒▒▒▒▒▒
  3.    ───────────────────────────────────────────────────────────────────────
  4.  
  5.           ░░░░ ▒▒▒ ▓▓▓▓ ▒▒▒▒▒ ▄███▄ ▓   ▓      Peter Burnett  2:441/80
  6.           ░  ░  ▒  ▓      ▒   █   █ ▓▓  ▓                
  7.           ░░░░  ▒  ▓▓▓▓   ▒   █   █ ▓ ▓ ▓      
  8.           ░     ▒     ▓   ▒   █   █ ▓  ▓▓
  9.           ░    ▒▒▒ ▓▓▓▓   ▒   ▀███▀ ▓   ▓                ┌─┐
  10.                                   ┌───────░·░─┐          │ │
  11.          ┌───┐ ┌───┐              │       ░·░ │          │ │
  12.          │ ┌─┘ └─┐ └──────────────│       ░·░ │┌─────────┘ └──┐
  13.          │ │     │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │       ░·░ │└───┬───┬      └───
  14.          │ └─┐ ┌─┘ ┌──────────────│       ░·░ │    └┬──┴┐
  15.          └───┘ └───┘              │       ░·░ │     └┬──┴┬      ┌────
  16.                                   └───────░·░─┘      └───┴──────┘
  17.  
  18.     Piston Popper BBS, Hastings, UK        ▓▓▓▓ ▄███▄ ░░░░ ▒▒▒▒ ▓▓▓▓ ███▄
  19.     +44-424-853361 - 14K4 Hst/V32/V42bis   ▓  ▓ █   █ ░  ░ ▒  ▒ ▓    █  █
  20.                                            ▓▓▓▓ █   █ ░░░░ ▒▒▒▒ ▓▓▓  ████
  21.                                            ▓    █   █ ░    ▒    ▓    █  █▌
  22.                                            ▓    ▀███▀ ░    ▒    ▓▓▓▓ █   █
  23.  
  24.               ╔══════════════════════════════════════════════╗
  25.               ║ Piston Popper Software Systems, Hastings, UK ║
  26.               ╚══════════════════════════════════════════════╝
  27.  
  28.                       PO Box No. 4
  29.                     St Leonards On Sea
  30.                      East Sussex
  31.                        England
  32.  
  33.                 Piston Popper Software
  34.  
  35.                           Proudly Presents!
  36.  
  37.          D'Bridge EchoMail Definitions File To Areas.Bbs Converter.  
  38.                                   Version 1.00
  39.  
  40.           Copyright (C) Aug 1992 Peter Burnett, All Rights Reserved
  41.  
  42.  
  43.    ───────────────────────────────────────────────────────────────────────
  44.    ▒▒▒ DBAG ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 1.00 ▒▒▒▒▒▒
  45.    ───────────────────────────────────────────────────────────────────────
  46.  
  47.  
  48.    ───────────────────────────────────────────────────────────────────────
  49.    ▒▒ DISCLAIMER & LICENSE ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  50.    ───────────────────────────────────────────────────────────────────────
  51.  
  52.    DBAG is FREEware *NOT* Public Domain!
  53.  
  54.    The documentation and accompanying program are copyrighted material 
  55.    designed, produced and tested by the author of the software.
  56.  
  57.    Although every care and attention has been taken to write and test the
  58.    program to make sure that it does what this documentation states, the
  59.    program is provided as it is, without warranty or guarantee of any kind,
  60.    either expressed or implied, as to the quality or performance of this
  61.    program, except that it will occupy disk space.
  62.  
  63.    The author shall not be held liable to you or anyone else for any direct,
  64.    indirect, incidental or consequential damages, including any lost profits,
  65.    lost savings, lost business, which may result from the use or inability 
  66.    to use this program.
  67.  
  68.    Your use of this program constitutes your agreement to this disclaimer and
  69.    your release of the author from any form of liability or litigation.
  70.  
  71.    You are actively encouraged to copy and distribute it in an unmodified way 
  72.    as much as you want, as long as you still abide to the conditions mentioned 
  73.    here and that no money or monies or any other form of compensation is asked
  74.    or accepted.
  75.  
  76.    ───────────────────────────────────────────────────────────────────────
  77.    ▒▒ CREDITS ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  78.    ───────────────────────────────────────────────────────────────────────
  79.  
  80.                  D'Bridge is the trademark of Chris Irwin
  81.  
  82.         DBAG was written in PASCAL and ASSEMBLER and is compiled by 
  83.         Borlands Turbo Pascal v6.00 & Borlands Turbo Assembler v2.00
  84.  
  85.         From an idea given to me by John Sangwin 2:250/408@fidonet
  86.  
  87.  
  88.    ───────────────────────────────────────────────────────────────────────
  89.    ▒▒ INTRODUCTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  90.    ───────────────────────────────────────────────────────────────────────
  91.  
  92.    What is DBAG ?          /* (DB)ridge (A)reas.bbs (G)enerator */
  93.  
  94.    DBAG will create an AREAS.BBS type file for you from the infomation
  95.    contained within the D'Bridge Mailer support files.
  96.  
  97.    The archive you downloaded/received should be named DBAG_100.??? where
  98.    ??? will be one of the many archive type extensions, ( Lzh, Pak, Arc
  99.    Zip, Arj ).
  100.  
  101.    The DBAG_100.??? archive may be converted to another archive format
  102.    provided that all the listed files below are included and no others
  103.    are added either.
  104.  
  105.    DBAG.EXE        The executable program.
  106.    DBAG.DOC        This documentation you are reading now.
  107.    UPDATE.100      Update, Debug & History Information
  108.  
  109.  
  110.  
  111.    ───────────────────────────────────────────────────────────────────────
  112.    ▒▒ HOW TO INSTALL IT !! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  113.    ───────────────────────────────────────────────────────────────────────
  114.  
  115.    Unpack the files from the archive and copy them into any directory
  116.    that is defined in your system "Path" environment variable.
  117.  
  118.    DBAG will use the environment variable "DB" to locate the
  119.    nessercary D'Bridge support files it requires for full execution.
  120.  
  121.  
  122.  
  123.    ───────────────────────────────────────────────────────────────────────
  124.    ▒▒ THE OUTPUT FILES ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  125.    ───────────────────────────────────────────────────────────────────────
  126.  
  127.    DBAG can be executed just be entering the command "DBAG". This will
  128.    create the output file "AREAS.BBS" in the current directory. The
  129.    format of the Areas.Bbs is that of the QUICKBBS format.
  130.  
  131.    Upto 2 Parameters ( case insensitive ) can be used on the command line 
  132.    for DBAG. These are as follows :-
  133.  
  134.    A "?" at any point in any of the parameters will cause the help screen 
  135.    to be displayed.
  136.  
  137.    A "/h" will also enable the help screen.
  138.  
  139.    A "/d" will create extended information in the output file. This is
  140.    defaulted to off. A typical output without the extended information 
  141.    is as below :-
  142.  
  143.     2 REGION25                2:253/158 440/11 441/80.1 86 87 88 90
  144.     4 CA_CLIPPER              2:253/158 440/11 441/89
  145.     5 HARDWARE                2:253/158 256/45 440/11 441/80.1 86 87
  146.     6 SYSLNGE                 2:253/158 440/11 441/80.1 86 87 88 89 90
  147.  
  148.    Where as the following is output when the "/d" option is enabled :-
  149.  
  150.     2 REGION25                2:253/158 440/11 441/80.1 86 87 88 90
  151.     ;  SPARE
  152.     4 CA_CLIPPER              2:253/158 440/11 441/89
  153.     5 HARDWARE                2:253/158 256/45 440/11 441/80.1 86 87
  154.     6 SYSLNGE                 2:253/158 440/11 441/80.1 86 87 88 89 90
  155.   
  156.    And this can show you where the gaps are in your echomail areas.
  157.  
  158.    The final parameter that can be used is a fully qualified filename,
  159.    ie. C:\DB\MailOut\441-80.ARS where the output file will be in the
  160.    "C:\Db\MailOut" directory and be called "441-80.ARS". With this
  161.    feature you can create a "Dos Event" within D'Bridge to automatically
  162.    create an Areas.Bbs type file at a given time and send it to any
  163.    node of your chosing, a typical example is that I wish to send my
  164.    echomail area forwading infomation to my Networks EchoMail Co-Ord
  165.    on a regular basis and using the 2 batch file commands below, this
  166.    is possible.....
  167.  
  168.           DBAG C:\Db\Outbound\441-80.Ars
  169.           Dbutil Send Crash 2:441/86 C:\Db\Outbound\441-80.Ars
  170.  
  171.    DBAG will suppress the ",C ,H ,I and ,N" characters bieng exported
  172.    to the output file. It will also suppress the associated node
  173.    number with the ",A" control character. If the forward to line in
  174.    the echomail manager was :-
  175.  
  176.             2:253/158 440/80,A 440/11,H 441/89 90,C
  177.  
  178.    then the output line in the areas.bbs file would be :-
  179.  
  180.             2:253/158 440/11 441/89 90
  181.  
  182.  
  183.    ───────────────────────────────────────────────────────────────────────
  184.    ▒▒ ERRORLEVELS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  185.    ───────────────────────────────────────────────────────────────────────
  186.  
  187.    DBAG currently produces lots different errorlevels as follows:
  188.  
  189.        -6   - Not Enough EMS Memory
  190.        -5   - EMS Driver Not Installed
  191.        -4   - Overlay File I/O Error
  192.        -3   - Not Enough Memory For Overlay Buffer
  193.        -2   - Overlay File Not Found
  194.        -1   - Overlay Manager Error
  195.     0   - OK. Program Terminated Normally
  196.         1   - Invalid Function Number
  197.         2   - File Not Found
  198.         3   - Path Not Found
  199.         4   - Too Many Open Files
  200.         5   - File Access Denied
  201.         6   - Invalid File Handle
  202.         8   - Not Enough MEMORY !
  203.         10  - Invalid Environment
  204.         11  - Invalid Format
  205.         12  - Invalid File Access Code
  206.         15  - Invalid Drive Number
  207.         16  - Cannot Remove Current Directory
  208.         17  - Cannot Rename Accross Drives
  209.         18  - No More Files
  210.         100 - Disk Read Error
  211.         101 - Disk Write Error
  212.         102 - File Not Assigned
  213.         103 - File Not Open
  214.         104 - File Not Open For Input
  215.         105 - File Not Open For Output
  216.         106 - Invailid Numeric Format
  217.         150 - Disk Is Write Protected
  218.         151 - Unknown Unit
  219.         152 - Drive Not Ready
  220.         153 - Unknown Command
  221.         154 - CRC Error In Data
  222.         155 - Bad Drive Request Structure Length
  223.         156 - Disk Seek Error
  224.         157 - Unknown Media Type
  225.         158 - Sector Not Found
  226.         159 - Printer Out Of Paper
  227.         160 - Device Write Fault
  228.         161 - Device Read Fault
  229.         162 - Hardware Failure
  230.         200 - Division By Zero
  231.         201 - Range Check Error
  232.         202 - Stack Overflow Error
  233.         203 - Heap Overflow Error
  234.         204 - Invalid Pointer Operation
  235.         205 - Foating Point Overflow
  236.         206 - Foating Point Underflow
  237.         207 - Invalid Floating Point Operation
  238.         208 - Overlay Manager Not Installed
  239.         209 - Overlay File Read Error
  240.         210 - Object Not Initialised
  241.         211 - Call To Abstract Method
  242.         212 - Stream Registration Error
  243.         213 - Collection Index Out Of Range
  244.         214 - Collection Overflow Error
  245.  
  246.    DBAG will generate other errorlevels but in this release they will
  247.    remain un-published as to what they mean, but in so much should an error
  248.    level greater than 0 be generated, then there is an error somewhere
  249.    in your setup of DBAG.
  250.  
  251.    ───────────────────────────────────────────────────────────────────────
  252.    ▒▒ DESQview Users ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  253.    ───────────────────────────────────────────────────────────────────────
  254.  
  255.    The program is DESQview aware and can be run inside a 128K Dos Window.
  256.  
  257.    When DBAG initialises it checks for the presence of the DESQview
  258.    multi-tasking environment and if active re-directs the screen to the
  259.    DESQview window in which it is running.
  260.  
  261.  
  262.    ───────────────────────────────────────────────────────────────────────
  263.    ▒▒ THANKS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  264.    ───────────────────────────────────────────────────────────────────────
  265.  
  266.    I would like to express my thanks to the below listed people. These
  267.    unfortunates tested ( broke ) and offered suggestions for DBAG.
  268.  
  269.    John Sangwin      2:250/480         Seven Side BBS
  270.    Ralph Davey       2:441/86          Six & Five Eights BBS
  271.  
  272.  
  273.    ───────────────────────────────────────────────────────────────────────
  274.    ▒▒ HELP!!! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  275.    ───────────────────────────────────────────────────────────────────────
  276.  
  277.    If you have any other problems/bug reports/suggestions I can be 
  278.    contacted via Fidonet Netmail on my BBS system at :-
  279.    
  280.                          2:441/80@fidonet
  281.    
  282.    or via snail mail:
  283.                          Piston Popper's, UK
  284.                          C/O Piston Popper Software
  285.                          PO Box No. 4
  286.                          St Leonards On Sea
  287.                          EAST SUSSEX
  288.                          UK    
  289.  
  290.     -=> +44-424-853361  v21, v22 & v22bis, 9600 & 14400 HST v32 v42bis <=-
  291.  
  292.    Please include in your report what version(s) of the below you are
  293.    using of the following, D'Bridge , Ms-Dos/Pc-Dos/4-Dos, DESQview,
  294.    Qemm and any other software/hardware details you think may be usefull
  295.    in tracking a problem down.
  296.  
  297.    If you have any suggestions, then please drop me a line!!
  298.  
  299.    Thanks for using my program!
  300.  
  301.    Peter Burnett - Author of DBAG.
  302.  
  303.  
  304.